home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / LANG / C / GCC / CLIB / !clib / h / time < prev    next >
Text File  |  1997-03-22  |  3KB  |  106 lines
  1. /* time.h
  2.  
  3.    For use with the GNU compilers and the SharedCLibrary.
  4.    (c) Copyright 1997, Nick Burrett.  */
  5.  
  6. #ifndef __time_h
  7. #define __time_h
  8.  
  9. #ifndef __STDDEF_H
  10. #include <stddef.h>
  11. #endif
  12.  
  13. #ifdef __cplusplus
  14. extern "C" {
  15. #endif
  16.  
  17. #ifdef __CLK_TCK
  18. /* Obsolete name for CLOCKS_PER_SEC.  */
  19. #define CLK_TCK __CLK_TCK
  20. /* Number of clock ticks per second measured by the clock function.  */
  21. #define CLOCKS_PER_SEC __CLK_TCK
  22. #else
  23. #define CLK_TCK 100
  24. #define CLOCKS_PER_SEC 100
  25. #endif
  26.  
  27. /* Type of the value returned by the clock() function. Represents
  28.    the number of seconds elapsed since 00:00:00 on January 1, 1970.   */
  29. typedef unsigned int clock_t;
  30. /* Returns the elapsed processor time since program execution. */
  31. extern clock_t clock(void);
  32.  
  33. /* Calendar time.  */
  34. typedef unsigned int time_t;
  35.  
  36. struct tm
  37. {
  38.   /* Number of seconds after the minute (0 through 59).  */
  39.   int tm_sec;
  40.   /* Number of minutes after the hour (0 through 59).  */
  41.   int tm_min;
  42.   /* Number of hours past midnight (0 through 23).  */
  43.   int tm_hour;
  44.   /* Day of the month (1 through 31).  */
  45.   int tm_mday;
  46.   /* Number of months since January (0 through 11).  */
  47.   int tm_mon;
  48.   /* Number of years since 1900.  */
  49.   int tm_year;
  50.   /* Number of days since Sunday (0 through 6).  */
  51.   int tm_wday;
  52.   /* Number of days since January 1 (0 through 365).  */
  53.   int tm_yday;
  54.   /* This flag indicates whether Daylight Saving Time is
  55.      (or was, or will be) in effect at the time described.
  56.      The value is positive is DST is in effect, zero if it is not,
  57.      and negative if the information is not available.  */
  58.   int tm_isdst;
  59. };
  60.  
  61. /* Return the number of seconds elapsed between time1 and time0
  62.    as a value of type double.  */
  63. extern double difftime (time_t time1, time_t time0);
  64.  
  65. /* Convert a broken-down time structure to a calendar time
  66.    representation.  */
  67. extern time_t mktime(struct tm *brokentime);
  68.  
  69. /* Return the current time as a value of type time_t.
  70.    If 'result' is non null, then the time will also be stored
  71.    in here.  */
  72. extern time_t time(time_t *result);
  73.  
  74. /* Convert the broken-down time value that 'brokentime'
  75.    points to into a string in a standard format:
  76.  
  77.      "Sat Mar 22 12:16:34 1997\n".  */
  78. extern char *asctime(const struct tm *brokentime);
  79.  
  80. /* Similar to asctime() except that the time value is
  81.    specified as a time_t calendar time value.  It is
  82.    equivalent to asctime (localtime (time)).  */
  83. extern char *ctime (const time_t *time);
  84.  
  85. /* Convert the calendar time pointed to by 'time' to broken-down
  86.    time representation, expressed relative to the user's
  87.    specified time zone.  */
  88. extern struct tm *localtime(const time_t *time);
  89.  
  90. /* Similar to localtime() except that the broken-down time
  91.    is expressed as GMT, rather than relative to the local time zone.  */
  92. extern struct tm *gmtime(const time_t *time);
  93.  
  94. /* Similar to the sprintf function but the conversion specifications
  95.    that can appear in the format template 'template' are specialized
  96.    for printing components of the date and time 'brokentime' according
  97.    to the locale currently specified for time conversion.  */
  98. extern size_t strftime (char *s, size_t size,
  99.                              const char *templ, const struct tm *brokentime);
  100.  
  101. #ifdef __cplusplus
  102. }
  103. #endif
  104.  
  105. #endif
  106.